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Preamble 
This tutorial provides a step-by-step procedure on how to set up Smap Server on Linux Ubuntu 
Desktop 16.04 LTS. 


Requirements 
e Minimum 10 GB of disk space on your computer 


e 64 bit Server 
e Java-8 
e Synaptic Package Manager 


1) Open Terminal and Run these following Commands 
sudo apt-get upgrade 
sudo apt-get update 


crim En | GS 4) 15:04 


ge Wi) 


os smap_17_10_ 


02_966.tgz _ fAchoolwe Ee r 
sinampande smap -. , 4 


i installation _Tag... nchoolwe@nchoolwe-Aspire-E1-531: ~ 
“3s fee) sudo apt-get _upgrade| 
nchoolweaaa™ [sudo] password for nchoolwe: 
household.xis "ay Reading package lists... Done 
> Building dependency tree 

Reading state information... Done 

Calculating upgrade... Done 

The following package was automatically installed and is no longer required: 
Libllvm4.0 

Use ‘sudo apt autoremove' to remove it. 

The following packages have been kept back: 
Linux-generic-hwe-16.04 Linux-headers-generic-hwe-16.04 
Linux-image-generic-hwe-16.04 

"The following packages will be upgraded: 
* firefox firefox-locale-en 
SPSS Training = ™ 2 upgraded, © newly installed, © to remove and 3 not upgraded. 
Need to get 44.4 MB of archives. 


bn | After this operation, © B of additional disk space will be used. 


Do you want to continue? [Y/n] y < ine 
™ Get:1 http://security.ubuntu.com/ubuntu xenial-security/main amd64 firefox amd64 ls 
57.0.4+buildi-Oubuntu0.16.04.1 [43.7 MB] : { 
nchoolwesmap > Get:2 http://security.ubuntu.com/ubuntu xenial-security/main amd64 firefox-local ae 
e-en amd64 57.0.4+buildi-Oubuntu0.16.04.1 [692 kB] 


be 
maftfal.odt Fetched 44.4 MB in 3min is (245 kB/s) 
" (Reading database ... 196925 files and directories currently installed.) 
Preparing to unpack .../firefox_57.0.4+buildi-Oubuntu0.16.04.1 amd64.deb ... 
w Unpacking firefox (57.0.4+build1-Oubuntu0.16.04.1) over (57.0.3+build1-Oubuntud. 
SUR oe 
Preparing to unpack .../firefox-locale-en_57.0.4+build1-Oubuntu0.16.04.1 amd64.d 


loolwe smap 
installation 
manual.pdf 
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Terminal Lim En| 4)) 15:22 +f 


nchoolwe@nchoolwe-Aspire-E1-531: ~ 


=nchoolwe@nchoolwe-Aspire-E1-531:~$ sudo apt-get update 

0% [Connecting to 192.168.0.4 (192.168.0.4)] [Connecting to 192.168.0.4 (192.16% 
#0% [Connecting to 192.168.0.4 (192.168.0.4)] [Connecting to 192.168.0.4 (192.16% 
©% [Connecting to 192.168.0.4 (192.168.0.4)] [Connecting to 192.168.0.4 (192.16 


= § Server Groups 
= £ Servers (2) 
= {§ PostgreSQL 9.5 (localhost:543 
Databases (2) 
Tablespaces (2) 
Group Roles (0) 
&. Login Roles (1) 























& postgres 
(9 localhost (127.0.0.1:5432) 
Databases (3) 
postgres 
9 results 
survey definitions 
Catalogs (2) 
Event Triggers (0) 
@p Extensions (2) 
— @ Schemas (1) 
5 © public 
¥® Collations (0) 
@ Domains (0) 
> FTS Configurations 
ij FTS Dictionaries (0 
 FTS Parsers (0) 
FTS Templates (0) 
Functions (1109) 
® Sequences (46) 
Tables (49) 
» Trigger Functions ( 





CREATE SCHEMA public 
AUTHORIZATION postgres; 


GRANT ALL ON SCHEMA public TO postgres; 
GRANT ALL ON SCHEMA public TO public; 
COMMENT ON SCHEMA public 

IS ‘standard public schema'; 








Restoring previous environment... Done. survey definitions on postgres@127.0.0.1:5432 3.8 secs 


2) Install Synaptic Package Manager, 


Run this command on terminal to install synaptic: sudo apt-get install synaptic 


Terminal 


or.ai 


ia OS smap_17_10_ 


02_966.tgz . : a 
= 9 root @nchoolwe-Aspire-E1-531: /home/nchoolwe 


Lia En | 4) 15:27 i 


nchoolwe@nchoolwe-Aspire-E1-531:~$ sudo su 
[sudo] password for nchoolwe: 
AChOoIWS meloha ile eleh ale tt hae oe wee ee ae see@ieeha meSUdGO apt-get install synaptic 
“ Reading package lists... Done 
household.xls recast 

Building dependency tree 
Reading state information... Done 
synaptic is already the newest version (0.83). 


The following package was automatically installed and is no longer required: 
Libllvm4.0 


Use 'sudo apt autoremove' to remove it. 
© upgraded, 0 newly installed, 0 to remove and 6 not upgraded. 
root@nchoolwe-Aspire-E1-531: /home/nchoolwe# 


SPSS Training 


—— 
#yr 


ee 





¥ Spay 


3) Open Synaptic package manager 
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c) 
ol '® synaptic 
& Applications 


mez: 


Synaptic Package 
Manager 


You will be prompted to type password to open synaptic 


NTidst-taldia@-|a- 


os smap_17_10_ 
02 966.tgz 


nchoolwe 


household.xls "y 
, 


Authentication is required to run the Synaptic Package Manager 


a An application is attempting to perform an action that requires privileges. 
Authentication is required to perform this action. 





Password: 


> Details 


4) Search for Apache2 on Synaptic and install all the required packages 
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og En] 4) 09:33 wt 


Filter results » 


ty & > @) 15:31 tf 





Synaptic Package Manager 








ro) 
— Cc a 
Reload MarkAllUpgrades Apply Properties 
i All Ss Package 
= CT) adzapper 
® @ apache2 
— ® @ apache2-bin 
== ® @ apache2-data 
= OF @ apache2-dbg 
C @ apache2-dev 
— ® @ apache2-doc 
0 apache2-suexec-custom 
= [|]  apache2-suexec-pristine 
" ® © apachez-utils 
= 1) cortado 
a [)  fusiondirectory-plugin-apact 
SOME Sorel | 
| Fusiondirectory-plugin-apact 
#5 [) gforge-web-apache2 
[1]  gitweb 
Ba [)  libapache-mod-jk-doc 
[)  libapache2-authcassimple-pe 
Gy [)  libapache2-authcookie-perl 
= Sections No package is selected. 
w 
Status 
= 4 os 
Origin 


Custom Filters 
Search Results 


Architecture 


137 packages listed, 1980 installed, 0 broken. 0 to install/upgrade, 


: 0° 8 ® 0) 09:34 





Q 


Search 


Installed Version Latest Version Description 


20090301.dfsg.1-0. proxy advertisement zapper add-on 

2.4.18-2ubuntu3.5 Apache HTTP Server 

2.4.18-2ubuntu3.5 Apache HTTP Server (modules and other binary files) 
2.4.18-2ubuntu3.5 Apache HTTP Server (common files) 

2.4.18-2ubuntu3.5 Apache debugging symbols 

2.4.18-2ubuntu3.5 Apache HTTP Server (development headers) 

2.4.18-2ubuntu3.5 Apache HTTP Server (on-site documentation) 

2.4.18-2ubuntu3.5 Apache HTTP Server configurable suexec program for mod_suexec 
Server standard suexec program for mod_suexec 
Server (utility programs for web servers) 

let For Ogg Formats 

thost plugin for FusionDirectory 

for FusionDirectory apachez2 plugin 

de package for FusionForge 

distributed revision control system (web interface) 
n of libapache2-mod-jk package 

Jule to authenticate trough a CAS server 
uthentication and Authorization via cookies 


2.4.18-2ubuntu3.5 
2.4.18-2ubuntu3.5 
2.4.18-2ubuntu3.5 


2.4.18-2ubuntu3.5 











) 
Ww 


Search: { 


Look in: 





DescriptionandName v 





Cancel QsSearch 


Oto remove 


5. Check Java version. Usually on Synaptic, Java automatically installs alongside Apache and 


Tomcat 


To check version of java type javac-version on the terminal and press enter 


6. Search for Tomcat7 on synaptic and install all the required packages 


Synaptic Package Manager 


Cc 


Reload 


re 


Mark All Upgrades Apply Properties 


All Package 





apache2 


libtomcat7-java 
tomcat7 
tomcat7-admin 
tomcat7-common 
tomcat7-docs 
tomcat7-examples 
tomcat7-user 


BSSESBBBEB v 


| ) 
= Sections No package is selected. 
= 
= 
Status 
— 
Origin 
Custom Filters 
Search Results 
= Architecture 


7.0.68-1ubuntu0.1 
7.0.68-1ubuntu0.1 
7.0.68-1ubuntu0.1 
7.0.68-1ubuntu0.1 
7.0.68-1ubuntu0.1 
7.0.68-1ubuntu0.1 
7.0.68-1ubuntu0.1 





Q 


Search 


Installed Version Latest Version 


7.0.68-1ubuntu0.1 
7.0.68-1ubuntu0.1 
7.0.68-1ubuntu0.1 
7.0.68-1ubuntu0.1 
7.0.68-1ubuntu0.1 
7.0.68-1ubuntu0.1 
7.0.68-1ubuntu0.1 


Description 

Servlet and JSP engine —core libraries 

Servlet and JSP engine 

Servlet and JSP engine —- admin web applications 
Servlet and JSP engine —- common files 

Servlet and JSP engine —- documentation 

Servlet and JSP engine —- example web applications 
Servlet and JSP engine — tools to create user instances 








Md 


Search: | tomcat7| 


Lookin: | DescriptionandName v 





Cancel | QsSearch 





7 packages listed, 1980 installed, 0 broken. 0 to install/upgrade, 0 to remove 


7. Install PosgreSQL 9.5 and PostGIS 2.2 

Download the Interactive installer by EnterpriseDB from here 
https://www.enterprisedb.com/downloads/postgres-postgresql-downloads#linux 
Choose version 9.5 and select your operating system then download 
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Download PostgreSQL | EnterpriseDB - Mozilla Firefox 










cS) $ Manage Forms xX ‘sf Ext2Read download x © download ext2-Goog E Download PostgreSQL X [as 


~ g | Sil Y It © 








¢)>¢e¢@ | © 











DOWNLOADS BLOG ENGLISH v 





POSTGRES 


2 wy 









v v v v v 
PRODUCTS USE CASES CUSTOMERS PARTNERS SERVICES AND SUPPORT TRAINING RESOURCES SEARCH LOGIN CONTACT 


Download PostgreSQL 


PostgreSQL 9.5.10 v 


HH GSO RPORwD 


Linux x86-64 v 





DOWNLOAD NOW 





Please note: Cookies should be enabled for the download process to 


function properly 


Supported Platforms 


The download will look like this, on your downloads folder 


Downloads 


ftHome Downloads 





= ‘ postgresql-9.5.10-2- 
fm Desktop linux-x64.run 


[) Documents 


. 
= dd Music 

©) Pictures 

ym =Videos 

Mee (0) Trash 

wm OS? Network 

(§) 267GBVolume | # 
OP (—) Computer 

Mee © Connect to Server 
i} 

= 


* 


The following requires root privileges, type sudo su and press entet to run from root on terminal 
Close Synaptic Package Manager and Open Terminal then navigate to PostgreSQL download e.g 
for me it was in the download folder, so on my terminal | will type # cd 
/home/nchoolwe/Downloads/ press enter 

then, list by typing Is in the terminal 

e.g /home/nchoolwe/Downloads/# Is 

execute by typing ./(and the file name) then press enter 
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Terminal 


i 


[eq 


$ Manage Forms x  |5* Ext2Read download | x © download ext2-Google xX Download PostgreSQL X 


< C ) @ ht enterprisedb.com ~~ OW arc + I\ © 





tx) nchoolwe@nchoolwe-Aspire-E1-531: ~/Downloads 


:~$ cd /home/nchoolwe/Downloads/ 
: $ ls — 
ext2explore-2.2.71.zip 


S$ ./postgresql-9.5.10-2-lLinux-x64.runff 


©® BD AF f+ 


7PsoOaFooa a Inne 


1 





The setup will start, you should get the following screen 


ey-1aty) & —— En 4))) 10:18 


$ Manage Forms x 5 Ext2Read download | X © download ext2-Google x Download PostgreSQL X 





< ir ) enterprisedb.com ~- OY + Ii\ © 


ENGLISH v 





2 
I 
e| 
o 
r 


*~S cd /home/nchoolwe/Downloads/ 


Packaged by: 


: Setup - PostgreSQL - >» 
[sudo] password for DB | 


root@nchoolwe-Aspir POSTGRES Welcome to the PostgreSQL Setup Wizard. K-X64.Fun 


it 


a 


A 





© & 








a 


= Back Next > Cancel 








Press next and choose PostgreSQL 9.5 
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Se: ese) aban: 








Pee En Se) Orel 





= 






© Stack Builder 3.0.0 





Welcome to Stack Builder 


Thus wizard will help you install additional software tr 
complement your PostgreSQL or EnterpriseDB Postgres Plus 


ation you are 


rstallenc 
Your computer must be 


} 


To begin, please select the insta 
ftware for trom the list below c 
connected to the internet before proceeding 





a 
1 


70 29D aoa aIHne 


0 


ty 
iY 


Stack Bullder 3.0.0 i) 
SB PESO GSevecei 
~—aeo AM 





: i: s wo * 3 8” 


Make sure the Stack Builder option is ticked and click Finish 


_Uburtu 10) us (Snag a 
Machine View Devices Help 
3 \oplicat 5 , ysten i un De s 106AM a bunt é ) %; 


C@@ Setup 


Completing the PostgreSQL Setup Wizard 


Setup has finished mstalling PostgreSQL on your 
computer 





Launch Stack Builder at exit? 
% Stack Builder may be used to download and mstall 
) 


additional tools. drivers and appications tc 
complement your PostgreSQL installation 


— PostgreSQL 


Enterprisens 


SB FE I0 BO Begece 


PostGIS will start Installing 
Follow the steps and put the postgreSQL password you set where it’s needed 


71Page 


PostgreSQL wants to make changes. Type your 
password to allow this. 








Name: John Paul 


pasword: [seneeese Sd 
_ Cancel | | oK | 





Choose Spatial Extensions and tick postGIS 2.2 then next 


Please select the applications you would like to 
install 
- & Categores 
* & Add-ons, tools and utiliti 
* & Database Drivers 
* & Database Server 
* & Registration-required and trial products 
* & Replication Solutions 


- & Spatial Extensions 


PSOR oo oWOnHe: 


3 


1 


is - 


neon 
aS 
i* 
han 


az 
SB PESO Greve 
~—eae 06 AM 





PostGIS will install 
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, eee En Se) en Oe 





SO@@ Setup 





installing PostGts 1.3.6-1 





Please wat while Setup mstalis PostGiS on your computer 
installing PostGiS 1,3.6-1 
Unpacking /opt/PostgreSQU/S. 3/PosGis fibilibgess-3.1.1.s0 





1702s O Roo 00008: 





ll: 
1 





4 


ty 
¥ 


P=) 
8 PEO BG Sagrcei 
2 1:07 AM 





, a alo 8 


Then click finish and Finish to end the Installation of PostgreSQL and PostGIS 


Videos 


, ee En Se) Oe 





AM @ ubunt e ® ty, 


"9 a Sunt 





Completing the PostGIS Setup Wizard 







ue-addéed 


EnterprseD® is the kading provider of v 
of o6 for the Postgres community 


products and service 


Please viet our website at www.enterprisedb.cor 


( PostgreSQL 


Enterprisepe a 


lt 
1 


720 RoanpnInne 





$ 
4 


B 
SB FF 50 OBagece 
06 AM 


» mee & 108A 





; iv: s w,”o * SB 7: 


This Installation comes with PgAdmin 3. On the Search Menu type PgAdmin 3 and open it 
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pgAdmin lll 


@ @ https://www.enterpris 

















Loi a-°PA-B- DSR P-*s O- °- QA B- BW BS-Qerbhank Fo-e-:, 
| < List Paragraph lvy| ks Jo ‘Liberation Serif || | 12 ¥,|| |B) 2 MS AS Oe lie ae ee | ee | ee 
& = [Le aro Be 2 " 2 wn 3 6. 7 + 2 9 19 Fi 12 a 13 ai16 fe sete & 2 ] =| ee 
~ sao =a 
=> 

| ™ pgAdmin E 
= “af i q ed ©1800 | fs @] Oe ele) (— = 
my ~~ 

= ! 
A 

= ® 
i 


fy 5) Version 1.22.0 


; 
i Copyright 2002 - 2016, The pgAdmin Development Team 


This software is released under the PostgreSOL Licence 











di] 


You should be able to see your databases 


pgAdmin Ill 
ime - @ 
Properties | Statistics Dependencies Dependents 


Property Value 


i Description PostgreSQL 9.5 
Service 

Hostname localhost 
Host Address 

Port 5433 

SSL Certificate File 

SSL Key File 

=| SSL Root Certificate File 

SSL Certificate Revocation List 

==] SSL Compression? yes 
Maintenance database postgres 
&=| Username postgres 
Store password? No 

F=| Restore environment? No 
Connected? No 


) 
Q 
4 


b @))) 10:49 if 





= ® Server Groups 
= f Servers (2) 
§¢ PostgreSQL 9.5 (localhost:5433) 
# [§ localhost (127.0.0.1:5432) 











SQL pane : (X) 





— 
¥ 


Retrieving details on server localhost... Done. 10 msec 
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8. NOW LETS INSTALL SMAP SERVER 


Download the latest TAR file from https://code.google.com/p/smap-suite/downloads/list 


ee En PS) ROR 


install 


ftHome Desktop smap _ install 


Recent 


apacheConfig.sh postg resql-9.3- 
Desktop 1102.jdbc41.jar 


Documents 


Home 


beh lo 
wv 


Downloads == a 
Sawie rename.sh resultsDb.sql setupDb.sql subscribers.sh 
Pictures 
Videos 


Trash 


© 
tit 
fB 
a) 
dd 
10} 
a 
@ 
ge 


Network 


267 GB Volume = 


Computer 


Ho B 


Connect to Server 


as awe Gil) i 


“install.sh” selected (13.0 kB) 





Extract the .TAR file and run the install.sh from the install folder on the Smap folder 


You can run the Insatll.sh by just dragging the file to the terminal but make sure you are on root 
and then press enter. 


ae En Ie )) Re a 2 


a 


os smap_17_10_ 
02_966.tqz = 
_ , [sudo] password for nchoolwe: 

nchoolwaae Mp sorry, try again. 


household.xlsx i[sudo] password for nchoolwe: 
root@nchoolwe-Aspire-£1-531: /home/nchoolwe# [] 


:~$ sudo su 


install.sh 
7 


install 





ftHome Desktop smap_ install 


Recent — 


Home | 





a: 


config_files misc_files src apacheConfig.sh bu.sh postgresql 
Desktop 1102.jdbc4 


Documents 





Downloads ; : = 
sacle re.sh rename.sh resultsDb.sql setupDb.sql subscribers.sh 
Pictures 
Videos 


Trash 


Oo Ge OQ ¢ OF DB O 


Network 


267 GB Volume = 


i] 
a 
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Press Enter to run and when prompted to press Y, do so!!! 
Terminal ae En I )) RO 2 


—y 


— 


os smap_17_10_ 


02 966.tgz Sha 


al root@nchoolwe-Aspire-E1-531: /home/nchoolwe 
yy 


. :~$ sudo su 
[sudo] password for nchoolwe: 
nchoolw Mes Sorry, try again. 
household.xlsx ™ [sudo] password for nchoolwe: 
root@nchoolwe-Aspire-E1-531:/home/nchoolwe# '/home/nchoolwe/Desktop/smap/install 
/install.sh' 







Recent 





"o 
install.sh postgresql 
1102.jdbc4 










Home 


Desktop 


IDVOR oR ooOHe 


Documents 


= 


ft wes 


} Downloads 


; bscribers.sh 
Music 


Pictures 
™ Videos 
(@) Trash 


‘ @? Network 


(—] 267GBVolume 4 


Smap Server was designed to install all the packages including Apache Tomcat, PostgreSQL, 
PostGIS etc, but on Ubuntu Desktop | have been facing some problems as the Smaps packages fail 
to install on their own. 


On this Tutorial we have already installed some packages such as Tomcat Apache, PostgreSQL and 
PostGIS, therefore Smap will skip all these packages and add on the leftovers without any 


problems. 


After the Installation is complete, run the patchdb.sh and the Deploy.sh in the Deploy folder to 
make sure all packages are updated 
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Terminal 


Ompb oO 


Hoo B@e@ed ¢ 





Recent 
Home 
Desktop 
Documents 
Downloads 
Music 
Pictures 
Videos 
Trash 


Network 


267 GB Volume 
Computer 


Connect to Server 


§ Paan 17 nF 412 


24 4 seed 





version1 deploy.sh patchdb.sh regenerateThumbs. SB 
sh a 
postgresql 
results.sql sd.sql 


root@nchoolwe-Aspire-E1-531: /home/nchoolwe 


root@nchoolwe-Aspire-E1-531:/home/nchoolwe# '/home/nchoolwe/Desktop/smap/deploy/ 
patchdb.sh' 
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Open browser and type localhost, Smap Server will open 


Smap Server - Mozilla Firefox 


ro) {J Smap Server 





a oy |" 


ID SORDDpwpD 


Bes 
Re 


—s 


" 


tT 


C a 


$ sMAP Server 


x 


+ 
- Ov 


@® localhost 


Login 





4" ! 
jt 


Documentation 


Lim En, BS @) 15:39 


ill 
© © A Ff 


anno 





Welcome to Smap Server Version: 17.10 


Changes in this release 


There are no announcements concerning the server today. 


4 





EN | Nt 


Highlight All 


Match Case WholeWords 2540f 315 matches 


Click login and put username and password as admin 


Specify users 
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ae En Pe )) Pea 2 
+ it O = 

Register Forgot Password 
x 


User Management - Mozilla Firefox 


o [J User Management <x Ee 


€ C a ® localhost/fieldManager/userManagement.ht —~ OY 


= # Users Modules ~ Forms Wifelaricolaiare Shared Resources ON ere la) Logs 





35 


Organisation: Nchoolwe P Sinampande 





Projects Roles Organisations Server 

. 

= Show users with security group: All ‘ 

Show users in project: All 

Ba Select User Id Name 
( he ) onli Administrator 

Ui 

v 

= 


Add User Delete User iV Co\t (im Kom @] ce Velie: 1e(e) a) 


0) 


“A =v HighlightAll MatchCase WholeWords 254 o0f 315 matches 


We are done. For more information on SSL and other very important things about Smap, refer to 
the Original Manual by Neil on the Smap Consulting link 
https://www.smap.com.au/downloads.shtml 


Enjoy your Smap Server, the Smart way of data collection! 


The End 
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